box: improve documentation

Rephrase a function parameter description and remove "." from all function parameters descriptions

Fixes https://gitlab.gnome.org/GNOME/gtk/-/issues/3499

diff --git a/gtk/gtkbox.c b/gtk/gtkbox.c
index 957678a3c0bcd4173446ed2fd4db660072b30c20..f59595a3b0b6d95ce27803551df4271752bf6290 100644 (file)
--- a/gtk/gtkbox.c
+++ b/gtk/gtkbox.c
@@ -317,8 +317,8 @@ gtk_box_buildable_iface_init (GtkBuildableIface *iface)
 
 /**
  * gtk_box_new:
- * @orientation: the box’s orientation.
- * @spacing: the number of pixels to place by default between children.
+ * @orientation: the box’s orientation
+ * @spacing: the number of pixels to place by default between children
  *
  * Creates a new #GtkBox.
  *
@@ -479,7 +479,7 @@ gtk_box_get_baseline_position (GtkBox *box)
  * gtk_box_insert_child_after:
  * @box: a #GtkBox
  * @child: the #GtkWidget to insert
- * @sibling: (nullable): the sibling to move @child after, or %NULL
+ * @sibling: (nullable): the sibling after which to insert @child
  *
  * Inserts @child in the position after @sibling in the list
  * of @box children. If @sibling is %NULL, insert @child at